SetMenuItemHierarchicalID

SetMenuItemHierarchicalID
Header:	Menus.h		Carbon status:	Supported

Attaches a submenu to a menu item.

OSErr SetMenuItemHierarchicalID (
    MenuHandle inMenu, 
    SInt16 inItem, 
    SInt16 inHierID
);

inMenu: A handle to the menu that contains the menu item to which you wish to attach a submenu.
inItem: An integer representing the item number of the menu item.
inHierID: An integer representing the menu ID of the submenu you wish to attach. This menu should be inserted into the menu list by calling InsertMenu.

function result: A result code.

DISCUSSION

The SetMenuItemHierarchicalID function should be called instead of setting the keyboard equivalent to 0x1B. When the Appearance Manager is available, you should call SetMenuItemHierarchicalID instead of SetItemMark to set the menu ID of a menu item’s submenu. However, you can still use SetItemMark to set the mark of a menu item.

VERSION NOTES

This function is available with Appearance Manager 1.0 and later.

Setting a submenu with an menu ID greater than 255 is only supported under Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when CarbonLib 1.0 or later is installed. Exported by CarbonLib 1.0 and later and by CarbonLib 1.0 and later.